home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 26 / Cream of the Crop 26.iso / os2 / uudbz002.zip / README < prev    next >
Text File  |  1997-08-09  |  7KB  |  185 lines
  1. This is the README documentation for the Mome Raths BBS package dbz for
  2. UUPC/Extended.  This package is not part of the UUPC distribution, but 
  3. is based upon their work.  UUPC/Extended is copyrighted, trademarked 
  4. software, and every effort has been made to not knowingly infringe upon
  5. either one.
  6.  
  7. However, the dbz.c and dbz.h that are in this distribution are original
  8. works.  It has been made public domain by myself, the author.
  9.  
  10.  
  11. These are the files you should have:
  12.  
  13. README -- this file, which explains the prerequisites, what dbz is, 
  14. what it is used for, what NoCEM is, why dbz is but isn't public domain 
  15. and why I wrote it.
  16.  
  17. Install.doc -- tells you how to install and use dbz.  How it may differ
  18. from other dbz programs.  How to recompile it using emx.
  19.  
  20. Makefile.dbz -- for using dmake to recompile dbz.
  21.  
  22. dbz.exe -- a compiled executable, ready-to-go
  23.  
  24. dbzMake.Cmd -- a REXX script that sets up the correct paths to compile 
  25. dbz.
  26.  
  27. dbz_mksetup.cmd -- a supporting REXX script called by dbzMake.Cmd, if 
  28. necessary.
  29.  
  30. patchme.cmd -- a rather brainless batch file that can be used to patch 
  31. the sources.
  32.  
  33. lib/lib.diff -- diff file for library files.
  34.  
  35. news/news.diff -- diff file for news files.
  36.  
  37. news/dbz.c -- source file for dbz executable.
  38.  
  39. news/dbz.h -- header file for dbz.
  40.  
  41.  
  42. Overview:
  43.  
  44. This dbz program is based upon the same concept as the C-News program of 
  45. the same name. I actually downloaded C-News and had a look at it.  The
  46. dbz program compiled without any problems whatsoever.  However, it
  47. bombed very quickly.  Looking at the program provided very few clues as
  48. to how they actually expected it to work, in actuality.  So, while it is
  49. intended to act similarly, I really don't know since I've never seen
  50. it actually work.  Comments on how it is supposed to work can be sent to
  51. MarchHare@momeraths.org.
  52.  
  53. The code itself is based upon, not surprisingly, genhist, which comes 
  54. with the UUPC/Extended package.  Portions of the code are copyright of
  55. Kew, and they are not being distributed with this package.  If you wish
  56. to modify and recompile it, you will need the source code that
  57. accompanies the UUPC/Extended package.  The source code packages are
  58. usually designated by the letter 'S' and should be available wherever
  59. you got UUPC.  If all else fails, try ftp.kew.com.  See section on
  60. Recompiling dbz in Install.doc, which also lists how to patch the 
  61. source code if you wish to recompile any of UUPC under OS/2's emx.
  62.  
  63.  
  64. Prerequisites:
  65.  
  66. An installed, running, working UUPC machine - If you don't have one of 
  67. these, you probably just wasted a small chunk of time.  The current 
  68. version of UUPC is 1.12s.  If you are using an older version, please 
  69. upgrade it.  Drew gets questions on a regular basis from people who 
  70. have run into a bug that has been fixed several revisions ago.  This 
  71. has not been tested on anything earlier, nor do I have the time or 
  72. desire to do so.  If you need to upgrade, check out http://www.kew.com 
  73. for the latest.
  74.  
  75. emx 0.9c development package, or equivalent runtime version - Please 
  76. note that several packages come with DLL's for emx.  This package does 
  77. not.  You should always make sure you only have one copy in your PATH 
  78. and LIBPATH statements, and that you are using the latest.  IMO, 
  79. distributing these files with the software is counter-productive, as 
  80. they become out-of-date so quickly.
  81.  
  82. zip/unzip - which I assume you have or you would not be reading this.
  83.  
  84.  
  85. Further prerequisites for compiling (this assumes you are compiling 
  86. with emx):
  87.  
  88. HPFS - the diff files are named with .diff as the extension.  I'm not 
  89. about to apologize for this.  One of the Rexx scripts is also above 
  90. the 8.3 format.  If you are running news on FAT, on OS/2 at least, you 
  91. get what you deserve.
  92.  
  93. emx development system 0.9c or later.
  94.  
  95. OS/2 port of GNU patch.
  96.  
  97. dmake, version 4 or higher
  98.  
  99.  
  100. What is dbz?
  101.  
  102. dbz is a program which can be used to test, extract information from, 
  103. add information to or check the existence of data within a BSD-type 
  104. database.  These databases are usually associated with news programs, 
  105. which track the history of incoming news messages or (in the case of 
  106. newsreaders) already read news messages.  The messages are inserted 
  107. into the database and indexed on the message ID number.
  108.  
  109.  
  110. Why would I want to use dbz?
  111.  
  112. There can be several reasons.  The most obvious is if you simply want 
  113. to test the functionality of the database.  However, it is unlikely 
  114. that you would want the package for this for various reasons.
  115.  
  116. The most likely reason you need dbz, and perhaps the least obvious, is 
  117. for NoCEM on spool.  Since you probably downloaded this package because
  118. you are running UUPC/Extended, then you can appreciate the difficulties
  119. involved in trying to run NoCEM.
  120.  
  121.  
  122. I'm using NNTP, can I still use this package?
  123.  
  124. Very unlikely.  Most NoCEM packages come with alternatives for NNTP.
  125.  
  126.  
  127. I'm using Waffle/Gigo/etc., not UUPC/Extended, can I still use this
  128. package?
  129.  
  130. Unknown and untested.  If you try it, back up your history files and/or
  131. have a way to rebuild them first.
  132.  
  133.  
  134. What is NoCEM?
  135.  
  136. NoCEM is a way to either mark as read or remove articles from a news
  137. spool which have been determined to be spam, Make-Money-Fast schemes or
  138. binary-in-discussion-group articles.  NoCEM just marks the messages as
  139. read, and is a user-oriented program.  NoCEM on spool is run by a
  140. newsadmin and actually removes the articles from the news spool.  A
  141. better explanation is at http://www.cm.org, the home of the Cancelmoose.
  142.  
  143.  
  144. Does this mean this is free?
  145.  
  146. Parts of this program are under copyright of UUPC/Extended.  The
  147. conditions of that package currently state that it is free, but a (very)
  148. small fee can get you telephone support.  Obviously, this is subject to
  149. change, although it is unlikely to change.  Please read the UUPC 
  150. documentation for specifics.
  151.  
  152. The part of this program written by myself is public domain.  You can do
  153. whatever you wish to do with it.  Those parts are the only ones included
  154. in this package.
  155.  
  156.  
  157. Public domain?  Does this mean it is worthless?
  158.  
  159. No.  It means that I want people to use it.  I want other programmers to
  160. include it (or parts thereof) into their programs.  I want people to
  161. realize, as well, that OS/2 and UUCP are not dead, and NNTP is not the
  162. only protocol affected by spam.  In fact, UUCP has more problems because
  163. of the time delays.
  164.  
  165.  
  166. So, you are porting NoCEM to OS/2?
  167.  
  168. It already exists as a Perl script, but it will need some tweaking for 
  169. use with UUPC under OS/2. Any Perl expert could do it, but I do plan to 
  170. do it, because I need to learn Perl anyways.  However, once that is 
  171. done, I'm going to put it into a REXX script as well.
  172.  
  173.  
  174. That's fine for news, but what about email?
  175.  
  176. Stay tuned...
  177.  
  178.  
  179. Will the OS/2 NoCEM be public domain as well?
  180.  
  181. The REXX script, undoubtedly.  The Perl script depends on whether it is
  182. a port or not, and what the license is on the original (if it is a
  183. port).
  184.  
  185.